home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / MPI_Scatterv.z / MPI_Scatterv
Encoding:
Text File  |  2002-10-03  |  4.7 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMPPPPIIII____SSSSCCCCAAAATTTTTTTTEEEERRRRVVVV((((3333))))                                                MMMMPPPPIIII____SSSSCCCCAAAATTTTTTTTEEEERRRRVVVV((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      MMMMPPPPIIII____SSSSccccaaaatttttttteeeerrrrvvvv - Scatters a buffer in parts to all tasks in a group
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      C:
  13.  
  14.           #include <mpi.h>
  15.  
  16.           int MPI_Scatterv ( _s_e_n_d_b_u_f, _s_e_n_d_c_n_t_s, _d_i_s_p_l_s, _s_e_n_d_t_y_p_e,
  17.           _r_e_c_v_b_u_f, _r_e_c_v_c_n_t, _r_e_c_v_t_y_p_e, _r_o_o_t, _c_o_m_m )
  18.           void             *_s_e_n_d_b_u_f;
  19.           int              *_s_e_n_d_c_n_t_s;
  20.           int              *_d_i_s_p_l_s;
  21.           MPI_Datatype      _s_e_n_d_t_y_p_e;
  22.           void             *_r_e_c_v_b_u_f;
  23.           int               _r_e_c_v_c_n_t;
  24.           MPI_Datatype      _r_e_c_v_t_y_p_e;
  25.           int               _r_o_o_t;
  26.           MPI_Comm          _c_o_m_m;
  27.  
  28.  
  29.      C++:
  30.  
  31.           #include <mpi.h>
  32.  
  33.           void Intracomm::Scatterv(
  34.           const void*       _s_e_n_d_b_u_f,
  35.           const int         _s_e_n_d_c_o_u_n_t_s[],
  36.           const int         _d_i_s_p_l_s[],
  37.           const Datatype&   _s_e_n_d_t_y_p_e,
  38.           void*             _r_e_c_v_b_u_f,
  39.           int               _r_e_c_v_c_o_u_n_t,
  40.           const Datatype&   _r_e_c_v_t_y_p_e,
  41.           int               _r_o_o_t) const
  42.  
  43.  
  44.      Fortran:
  45.  
  46.           INCLUDE "mpif.h" (or USE MPI)
  47.  
  48.           <type> SENDBUF(*), RECVBUF(*)
  49.           INTEGER _s_e_n_d_c_o_u_n_t_s(*), _d_i_s_p_l_s(*), _s_e_n_d_t_y_p_e, _r_e_c_v_c_o_u_n_t,
  50.           _r_e_c_v_t_y_p_e, _r_o_o_t, _c_o_m_m, _i_e_r_r_o_r
  51.  
  52.           CALL MPI_SCATTERV(_s_e_n_d_b_u_f, _s_e_n_d_c_o_u_n_t_s(*), _d_i_s_p_l_s(*), _s_e_n_d_t_y_p_e,
  53.           _r_e_c_v_b_u_f,_r_e_c_v_c_o_u_n_t, _r_e_c_v_t_y_p_e, _r_o_o_t, _c_o_m_m, _i_e_r_r_o_r)
  54.  
  55.  
  56. SSSSTTTTAAAANNNNDDDDAAAARRRRDDDDSSSS
  57.      This release implements the MPI 1.2 standard, as documented by the MPI
  58.      Forum in the spring 1997 release of _M_P_I:  _A _M_e_s_s_a_g_e _P_a_s_s_i_n_g _I_n_t_e_r_f_a_c_e
  59.      _S_t_a_n_d_a_r_d.
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMPPPPIIII____SSSSCCCCAAAATTTTTTTTEEEERRRRVVVV((((3333))))                                                MMMMPPPPIIII____SSSSCCCCAAAATTTTTTTTEEEERRRRVVVV((((3333))))
  71.  
  72.  
  73.  
  74. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  75.      The MMMMPPPPIIII____SSSSccccaaaatttttttteeeerrrrvvvv routine scatters a buffer in parts to all tasks in a
  76.      group.  This routine accepts the following parameters:
  77.  
  78.      _s_e_n_d_b_u_f        Specifies the address of the send buffer (choice,
  79.                     significant only at root).
  80.  
  81.      _s_e_n_d_c_n_t_s       Specifies the integer array (of length group size,
  82.                     specified in _c_o_m_m) that indicates the number of elements
  83.                     to send to each processor.
  84.  
  85.      _d_i_s_p_l_s         Specifies the integer array (of length group size,
  86.                     specified in _c_o_m_m).  Entry _i specifies the displacement
  87.                     (relative to _s_e_n_d_b_u_f) from which to take the outgoing data
  88.                     to process _i.
  89.  
  90.      _s_e_n_d_t_y_p_e       Specifies the data type of send buffer elements (handle).
  91.  
  92.      _r_e_c_v_c_n_t        Specifies the number of elements in the receive buffer
  93.                     (integer).
  94.  
  95.      _r_e_c_v_t_y_p_e       Specifies the data type of the receive buffer elements
  96.                     (handle).
  97.  
  98.      _r_o_o_t           Specifies the rank of the sending process (integer).
  99.  
  100.      _c_o_m_m           Specifies the communicator (handle).
  101.  
  102.      _r_e_c_v_b_u_f        Returns the address of the receive buffer (choice).
  103.  
  104.      _i_e_r_r_o_r         Specifies the return code value for successful completion,
  105.                     which is in MPI_SUCCESS.  MPI_SUCCESS is defined in the
  106.                     mmmmppppiiiiffff....hhhh file.
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.